Lookup is an autocomplete combobox that will search against a database object.
BaseDesktop OnlyRequires ui:scrollerWrapper
Note — A lookup is a combobox component, please find implementation documentation under the combobox component
The lookup can parse through single or multi scoped datasets. The parsed dataset can be filtered by single or multi option selects.
You can find the lookup component throughout most data fields that allow inline inputs. Most commonly used on record home and object home.
Lookups allow the user to have dual keyboard focus: while focus in the input search field, the user can type text into the field and simultaneously use arrow keys to navigate up and down the results list. Use the appropriate ARIA attributes in your markup in order to effectively communicate the relationship between the input field and the results list to users of assistive technology.
- Input field has attributes
- Input field has an
aria-expandedattribute whose value is
falsewhen the results list is hidden,
truewhen the results list is visible
- Input field has an
aria-activedescendantattribute whose value is the id of the highlighted results list option, no value if nothing’s highlighted in the list
- Results list is an
<ul role="presentation">, where each item is containing an
Expected keyboard interactions:
- Character keys filter the list
- Up and down arrow keys cycle through the available options in the list and
update the input field’s
- Enter key selects highlighted option and collapses the results list
- Escape key collapses the results list
Overview of CSS Classes
- The CSS class being referred to.
- A description of what the class does.
- Whether the class name is dev-ready (meaning it's fully vetted and tested and safe to use) or prototype (which means it's not fully vetted yet).
- The selector that the class name is allowed to be used on.
- The base level pattern for a component. A variant can be extended to create another variant of that component, for example, a stateful button is a derivative of the base button.
- A single class that can be added to an HTML element of a component to modify its output. Typically these will be colors, sizing and positioning.